Release 10.1A: OpenEdge Development:
ADM Reference

formattedWidgetValueList

Takes the name of one or more objects and returns the SCREEN-VALUE of the object or objects. For example, use this function to retrieve the formatted values of several fields to assign their screen values to other fields.

If the object is a browse column (called from within a ROW-DISPLAY trigger), the STRING-VALUE from the RowObject buffer field is added to the list of returned values.

If the object is a SmartDataField, the DataValue field is returned. The DataValue field is always the key field, even when the display field is different.

If a field in the list is not found or a field has an unknown value, the function returns “?” for its value in the returned character list.

Location: visual.p

Parameters:

INPUT namelist AS CHARACTER

The name of one or more objects, separated by commas.

INPUT delimiter AS CHARACTER

(Optional) Specifies the delimiter to use for the return value only. Specify “?” to use the default delimiter, which is the pipe character (“|”).

Returns: CHARACTER

Notes: Use the pipe (“|”) delimiter in the DHTML client, since manipulating unprintable characters such as CHR(3) is problematic. The delimiter is optional. If not specified it defaults to the pipe delimiter.

Examples:

The following illustrates the use of this method in 4GL code for use with a graphical user interface:

ASSIGN cValues = formattedWidgetValueList("salesrepviewv.region,county,city":U, CHR(3)) cCounty = ENTRY(2, cValues, CHR(3)). assignWidgetValue("county":U, cCounty).

The following illustrates the use of this method in DHTML code for use with a Web browser:

cvalues=logic.formattedWidgetValueList(‘salesrepviewv.region, salesrepviewv.city’,’|’);